Compartir a través de


Manage orders - Gets a product promotion by id.

Obtiene los detalles de la promoción por identificador.

GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}
GET https://api.partnercenter.microsoft.com/v{version}/productpromotions/{id}?country={country}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
id
path True

string

Identificador de promoción.

version
path True

string

country
query

string

Código de país.

Encabezado de la solicitud

Nombre Requerido Tipo Description
Authorization True

string

Token de portador de autorización

ms-correlationid

string

Se usa para realizar el seguimiento de las solicitudes internamente. Si no se proporciona un ms-correlationid, el servidor generará uno nuevo para cada solicitud.

MS-CV

string

Se usa para realizar el seguimiento de las solicitudes internamente. Si no se proporciona un MS-CV, el servidor generará uno nuevo para cada solicitud.

ms-requestid

string

Se usa para la idempoencia de las solicitudes. Si no se proporciona un ms-requestid, el servidor generará uno nuevo para cada solicitud.

Respuestas

Nombre Tipo Description
200 OK

Contracts.V1.Models.ProductPromotion

La solicitud se realizó correctamente. El cuerpo de la respuesta contendrá los detalles de la promoción.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

400 Bad Request

Faltaba o faltaba una entrada no válida. El cuerpo de la respuesta proporcionará los detalles del error.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

401 Unauthorized

La solicitud no se autenticó. El cliente debe autenticarse primero con el servicio de API del asociado.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

403 Forbidden

La solicitud se autenticó pero se rechazó, ya que el autor de la llamada no tiene los derechos para invocarla.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

404 Not Found

El recurso no se encuentra o no está disponible con los parámetros de entrada especificados.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

500 Internal Server Error

El servicio de API del asociado o una de sus dependencias no pudieron cumplir la solicitud.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definiciones

Nombre Description
Contracts.V1.Models.ProductPromotion
Contracts.V1.Models.ProductPromotionPricingPolicy
Contracts.V1.Models.ProductPromotionProperties
Contracts.V1.Models.ProductPromotionRequiredProduct
Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotion

Nombre Tipo Description
description

string

endDate

string

id

string

name

string

properties

Contracts.V1.Models.ProductPromotionProperties

requiredProducts

Contracts.V1.Models.ProductPromotionRequiredProduct[]

startDate

string

Contracts.V1.Models.ProductPromotionPricingPolicy

Nombre Tipo Description
policyType

string

value

string

Contracts.V1.Models.ProductPromotionProperties

Nombre Tipo Description
isAutoApplicable

boolean

Contracts.V1.Models.ProductPromotionRequiredProduct

Nombre Tipo Description
pricingPolicies

Contracts.V1.Models.ProductPromotionPricingPolicy[]

productId

string

skuId

string

term

Contracts.V1.Models.ProductPromotionTerm

Contracts.V1.Models.ProductPromotionTerm

Nombre Tipo Description
billingCycle

string

duration

string